home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / T / The Survey Editor2.0.HC.cpt / The Survey Editor 2.0 / card_2136.txt < prev    next >
Text File  |  1990-01-30  |  13KB  |  257 lines

  1. -- card: 2136 from stack: in.0
  2. -- bmap block id: 2478
  3. -- flags: 0000
  4. -- background id: 2767
  5. -- name: about
  6. ----- HyperTalk script -----
  7. on openCard
  8.   menuHandler "hide","Editor",0
  9.   menuHandler "hide","commands",0
  10. end openCard
  11.  
  12. on CloseCard
  13.   hide cd field "english instructions"
  14.   hide cd field "instructions fran√ßaises"
  15.   show cd btn "instructions"
  16.   hide cd btn "hide instructions"
  17.   menuHandler "show","Editor",0
  18.   menuHandler "show","commands",0
  19. end closeCard
  20.  
  21.  
  22.  
  23. -- part 3 (button)
  24. -- low flags: 00
  25. -- high flags: C002
  26. -- rect: left=0 top=0 right=20 bottom=512
  27. -- title width / last selected line: 0
  28. -- icon id / first selected line: 0 / 0
  29. -- text alignment: 1
  30. -- font id: 0
  31. -- text size: 12
  32. -- style flags: 0
  33. -- line height: 16
  34. -- part name: The Survey Editor 2.0    (c) 1990 Pierrot Vachon
  35.  
  36.  
  37. -- part 4 (button)
  38. -- low flags: 00
  39. -- high flags: A003
  40. -- rect: left=122 top=297 right=319 bottom=236
  41. -- title width / last selected line: 0
  42. -- icon id / first selected line: 0 / 0
  43. -- text alignment: 1
  44. -- font id: 0
  45. -- text size: 12
  46. -- style flags: 0
  47. -- line height: 16
  48. -- part name: Return
  49. ----- HyperTalk script -----
  50. on mouseUp
  51.   lock screen
  52.   go cd 1
  53.   unlock screen with iris close
  54. end mouseUp
  55.  
  56.  
  57.  
  58. -- part 5 (button)
  59. -- low flags: 00
  60. -- high flags: A003
  61. -- rect: left=277 top=297 right=319 bottom=391
  62. -- title width / last selected line: 0
  63. -- icon id / first selected line: 0 / 0
  64. -- text alignment: 1
  65. -- font id: 0
  66. -- text size: 12
  67. -- style flags: 0
  68. -- line height: 16
  69. -- part name: Instructions
  70. ----- HyperTalk script -----
  71. on mouseUp
  72.   lock screen
  73.   answer "Instructions in what language?" with "En fran√ßais" or "In English"
  74.   if it is "En fran√ßais" then
  75.     set the scroll of cd field "instructions fran√ßaises" to 0
  76.     set the visible of cd field "instructions fran√ßaises" to not the visible of cd field "instructions fran√ßaises"
  77.   else
  78.     set the scroll of cd field "english instructions" to 0
  79.     set the visible of cd field "english instructions" to not the visible of cd field "english instructions"
  80.   end if
  81.   hide me
  82.   show cd btn "hide instructions"
  83. end mouseUp
  84.  
  85.  
  86.  
  87. -- part 6 (field)
  88. -- low flags: 81
  89. -- high flags: 2007
  90. -- rect: left=91 top=104 right=286 bottom=420
  91. -- title width / last selected line: 0
  92. -- icon id / first selected line: 0 / 0
  93. -- text alignment: 0
  94. -- font id: 3
  95. -- text size: 9
  96. -- style flags: 0
  97. -- line height: 12
  98. -- part name: english instructions
  99. ----- HyperTalk script -----
  100. on mouseUp
  101.   hide me
  102.   show cd btn "instructions"
  103.   hide cd btn "hide instructions"
  104. end mouseUp
  105.  
  106.  
  107.  
  108. -- part 12 (field)
  109. -- low flags: 81
  110. -- high flags: 2007
  111. -- rect: left=91 top=105 right=286 bottom=421
  112. -- title width / last selected line: 0
  113. -- icon id / first selected line: 0 / 0
  114. -- text alignment: 0
  115. -- font id: 3
  116. -- text size: 9
  117. -- style flags: 0
  118. -- line height: 12
  119. -- part name: instructions françaises
  120. ----- HyperTalk script -----
  121. on mouseUp
  122.   hide me
  123.   show cd btn "instructions"
  124.   hide cd btn "hide instructions"
  125. end mouseUp
  126.  
  127.  
  128.  
  129. -- part 13 (button)
  130. -- low flags: 80
  131. -- high flags: A003
  132. -- rect: left=271 top=297 right=319 bottom=396
  133. -- title width / last selected line: 0
  134. -- icon id / first selected line: 0 / 0
  135. -- text alignment: 1
  136. -- font id: 0
  137. -- text size: 12
  138. -- style flags: 0
  139. -- line height: 16
  140. -- part name: Hide Instructions
  141. ----- HyperTalk script -----
  142. on mouseUp
  143.   lock screen
  144.   hide cd field "instructions fran√ßaises"
  145.   hide cd field "english instructions"
  146.   hide me
  147.   show cd btn "instructions"
  148. end mouseUp
  149.  
  150.  
  151.  
  152. -- part contents for card part 6
  153. ----- text -----
  154. DESCRIPTION
  155. ------------
  156.     The Survey Editor is a HyperCard stack written to help Sysops create and/or edit survey files for the Red Ryder Host BBS software. Please note that some commands listed in The Survey Editor may require version Red Ryder Host 2.0 or later to work as expected.
  157.  
  158.     This version of The Survey Editor has been released for those of you Sysops who are currently running a Red Ryder Host BBS and who know the hassle of programming a survey file. I hope that with the help of this program your programming nightmares have come to an end. Anyway, if you find The Survey Editor useful, please send me a postcard telling some infos about what you think of this program, and some informations about your bbs.
  159.  
  160. COPYRIGHT NOTICE
  161. -----------------
  162.  
  163.     The Survey Editor is a Shareware utility. According to that, you are entitled to copy and use it freely. However, there is ONE restriction: nobody has the right to distribute The Survey Editor as a commercial product. I'm the only person who has legal rights on The Survey Editor program and its included documentation.
  164.  
  165. INSTRUCTIONS
  166. -------------
  167.     Even though The Survey Editor program is a lot easier to work with than the usual way of creating Red Ryder Host survey files, you need to read the chapter about surveys in the Red Ryder Host user's manual. That way you will fully understand every details about survey commands. If you omit to do so, you expose yourself to some problems while using The Survey Editor.
  168.  
  169.     You must use the same linear programmation concept as if you were creating a survey file using the ‚Äúhard‚Äù way. What The Survey Editor does is to facilitate the handling of survey files. Unfortunately, it doesn't do all the job for you (not yet!).
  170.  
  171. HINTS & TRICKS
  172. ---------------
  173.     When deleting a line, if you want to bypass the confirmation dialog box, hold the shift key down.
  174.     Holding the option key down when clicking on the main window repeats the last action selected.
  175.  
  176. RESTRICTIONS:
  177. --------------
  178.     There is no trouble opening and editing a survey file written by another Sysop but be aware of this: due to the absence of standards in the survey programmation language, some unused lines about some commands may appear a little bit strange on the main window. However, the survey file may be edited without any problems (if the conditions below are respected).
  179.  
  180.     Due to the word wrap of HyperCard fields (it can't be disabled), a line must NOT exceed the width of the main window. So take good care about it. Here is a hint: you can change the font of the main window to Helvetica Condensed or a similar one. Although the text will be harder to read, you'll get more characters per line.
  181.  
  182.     The ‚ÄúLabel Above Command‚Äù option from the ‚ÄúCommands‚Äù menu is very useful when you need to have a clearer overview of your survey file but, when it is selected, you cannot use the other, ‚ÄúReplace‚Äù, ‚ÄúInsert‚Äù, ‚ÄúEdit‚Äù, ‚ÄúDelete‚Äù, or ‚ÄúShow Code of a Line‚Äù options. This function has been implemented to avoid confusion when converting the TEXT survey file you have created and/or edited to a RRH survey file.  However, you can print your survey file by using the ‚ÄúPrint‚Äù command in the ‚ÄúEditor‚Äù menu.
  183.  
  184. THE FINAL WORD
  185. ---------------
  186.     Now, it's up to you and to your imagination. Feel free to try lots of things with your copy of The Survey Editor. And, please, don't keep The Survey Editor program and the survey files you create just for yourself. Share them with other Red Ryder Host BBS Sysops that you know of. You'll see, they are good people to know when something happens...
  187.  
  188.     Thanks to all the authors of external commands and functions I uses in The Survey Editor. Without their work I could not have brought The Survey Editor to live. They help many HyperCard programmers when they publicly released ‚ÄúPrintField‚Äù, 
  189. ‚ÄúWriteToFile‚Äù, ‚ÄúMenuHandler‚Äù, ‚ÄúFileName‚Äù, ‚ÄúNewFileName‚Äù, 
  190. ‚ÄúStringWidth‚Äù, and ‚ÄúPopUpMenu‚Äù. Thanks again guys! The others XCMDs and XFCNs used by The Survey Editor are from me.
  191.  
  192.  
  193.  
  194. Pierrot Vachon
  195. 1250 rue B√©gin
  196. Chicoutimi, Qu√©bec
  197. G7H 4P4
  198.  
  199. Compuserve: 72407,3434
  200. GEnie: XTH87073
  201.  
  202. -- part contents for card part 12
  203. ----- text -----
  204. DESCRIPTION
  205. ------------
  206.     Ce logiciel est une pile HyperCard cr√©√©e pour aider les op√©rateurs de babillard √©lectronique utilisant Red Ryder Host √† cr√©er et/ou √©diter des fichiers de sondage. Cependant, veuillez noter que quelques commandes list√©es n√©cessitent la version 2.0 de Red Ryder Host pour fonctionner convenablement.
  207.  
  208.     Cette version de 'The Survey Editor' est distribu√©e dans le public pour les op√©rateurs qui utilisent Red Ryder Host et qui √©prouvent des difficult√©es a cr√©er un sondage en utilisant la m√©thode 'manuelle'. J'esp√®re qu'avec l'aide de ce programme, vos cauchemards seront finis, et que vous aurez davantage le go√ªt d'apporter √† vos utilisateurs de BBS des sondages encore plus int√©ressants. 
  209.  
  210.     Quoi qu'il en soit, si vous utilisez 'The Survey Editor', je vous demande de me faire parvenir une carte postale me disant comment vous trouvez 'The Survey Editor', ce que vous aimeriez qu'il y soit ajout√©, et donnant des informations sur le babillard √©lectronique que vous op√©rez.
  211.  
  212. NOTE DE DROITS D'AUTEUR
  213. ------------------------
  214.     'The Survey Editor' est du domaine public. Selon ce principe, vous √™tes encourag√©s √† le distribuer librement. Cependant, vous ne pouvez changer et/ou enlever la documentation qu'il contient. Vous ne pouvez √©galement distribuer cette pile Hypercard √† l'int√©rieur d'un logiciel distribu√© selon la m√©thode traditionnelle 
  215. (commerciale).
  216.  
  217. INSTRUCTIONS
  218. -------------
  219.     M√™me si 'The Survey Editor' est un logiciel facile √† utiliser, il vous est conseill√© de vous r√©f√©rer au manuel d'utilisation de Red Ryder Host afin d'obtenir une description d√©taill√©e des commandes de sondage qui vous permettront alors de comprendre chacune des √©tapes qui composent un fichier de sondage.
  220.  
  221.     Vous devez utiliser le m√™me concept de programmation 
  222. 'lin√©aire' que vous utilisiez auparavant. Ce que 'The Survey Editor' fait pour vous, c'est de faciliter grandement la manipulation des commandes de sondage ainsi que vous les pr√©senter sous une forme beaucoup plus facile √† comprendre.
  223.  
  224. TRUCS ET ASTUCES
  225. ------------------
  226.     Si vous d√©sirez passer outre le dialogue de confirmation lorsque vous d√©sirez effacer une ligne, appuyez sur la touche shift en cliquant sur la ligne d√©sir√©e (√©videmment apr√®s avoir s√©lectionner l'option 'delete' dans le menu 'Commands').
  227.  
  228.     Pour r√©p√©ter la derni√®re fonction choisie dans le menu 
  229. 'commands', maintenez la touche option enfonc√©e en cliquant sur la ligne d√©sir√©e.
  230.  
  231. RESTRICTIONS:
  232. --------------
  233.     Il n'y a pas de probl√®mes √† ouvrir un fichier de sondage cr√©√© par quelqu'autre logiciel que 'The Survey Editor'. Cependant, il est √† noter que d√ª √† l'absence de standards dans le langage de programmation de Red Ryder Host, quelques lignes peuvent donner un aper√ßu non d√©sir√©. Mais soyez sans craintes car le sondage peut √™tre √©dit√© √† volont√© sans probl√®mes (si les conditions √©num√©r√©es ci-bas sont respect√©es).
  234.  
  235.     D√ª √† la caract√©ristique des champs HyperCard qui ram√®ne automatiquement les mots sur la ligne suivante (√ßa ne peut √™tre mis hors d'usage), une commande ne devrait jamais exc√©der une ligne (la largeur de la fen√™tre principale). Vous pouvez obtenir plus de caract√®res dans une ligne en changeant la police de caract√®re.
  236.  
  237.     L'option 'Label Above Command" dans le menu 'Commands' est tr√®s utile lorsque vous d√©sirez obtenir un apper√ßu plus global de votre sondage. Cette option change la position des √©tiquettes qui se retrouvent normalement √† la fin de chaque ligne (lorsqu'une √©tiquette est assign√©e) pour les placer au-dessus de la ligne de commande √† laquelle elle appartient. Vous obtiendrez alors une vue d'ensemble assez int√©ressante! Cependant, vous n'aurez pas acc√®s aux commandes, 'Replace', 'Insert', 'Edit', 'Delete' ou 
  238. 'Show Code of a Line'. Vous pouvez cependant imprimer votre fichier de sondage si vous le d√©sirez en utilisant la commande 
  239. 'Print' dans le menu 'Editor'.
  240.  
  241. POUR FINIR...
  242. ------------
  243.     Vous √™tes maintenant laiss√©s √† votre imagination. N'h√©sitez pas √† faire toutes sortes de tentatives avec votre copie de 
  244. 'The Survey Editor'. Un conseil: partagez avec d'autres op√©rateurs (Sysops) vos trouvailles et faites-leur  √©galement cadeau d'une copie de ce programme. Ils appr√©cieront s√ªrement! 
  245.  
  246.     Merci aux auteurs des commandes et fonctions externes sans lesquelles il aurait √©t√© trop difficile de mettre √† terme 'The Survey Editor'. Je remercie tout particuli√®rement les auteurs qui ont rendu 'PrintField', 'WriteToFile', 'MenuHandler', 'FileName', 
  247. 'NewFileName', 'PopUpMenu', et 'StringWidth'  disponibles au public. Les autres XCMD et XFCN utilis√©es par 'The Survey Editor' ont √©t√© le fruit de mon travail personnel.
  248.  
  249.  
  250.  
  251. Pierrot Vachon
  252. 1250 rue B√©gin
  253. Chicoutimi, Qu√©bec
  254. G7H 4P4
  255.  
  256. Compuserve: 72407,3434
  257. GEnie: XTH87073